CONTENTS | INDEX | PREV | NEXT

 FUNCTION
 Create Link Libraries from .FD files

 SYNOPSIS
 FDTOLIB files/wildcard.fd [-h hdrfile] -o libname [-mr] [-mD]

 DESCRIPTION
 FDTOLIB will create an amiga standard link library out of specified
 .FD files (for example, you can generate most of amiga.lib by using
 the .FD files on your 1.3 Extras disk).  .FD files are a standard
 format file that describe the function names and offsets of shared
 Amiga (Exec) libraries.  See section for a description of the format.
 fdtolib creates the interface stubs and the AutoInit code used by
 DICE to automatically open and close the library.

 Basically, FDTOLIB will generate one of four types of libraries:

  Option  : Library Type
  ========+=========================================================
  default : small-data model
  --------+---------------------------------------------------------
  -mD     : large-data model
  --------+---------------------------------------------------------
  -mr     : small-data model + DICE registered parameters entry pts
  --------+---------------------------------------------------------
  -mr -mD : large-data model + DICE registered parameters entry pts
  --------+---------------------------------------------------------

 If -mr is used suitable prototypes must be specified with the -h
 option. In this case, FDTOLIB will run DCC with a special option to
 have it generate a register-specification file for it to match up
 again the .FD files.

 FDTOLIB then proceeds to scan the .FD files, creating temporary
 assembly files in T: and assembling them with DAS, then appending
 them to

 the output library and deleting the scratch files.  This step occurs
 for each function in each .FD files.

 (For faster operation, you will want to make DAS resident for the
 duration)

 If -mr was specified, FDTOLIB only generates library entries for
 those routines for which a prototype exists.  At the end of the run
 FDTOLIB will report any routines which existed in the .FD files but
 did not have a prototype.

 files/wildcard.fd specifies one or more files and/or AmigaDOS
 wildcarding that represents the .FD files that are to be processed
 into a library

 -h hdrfile
     hdrfile is a .H files that #include's all prototypes associated
     with the .FD files.  It is only used if the -mr option is
     specified

 -o libname
     specify output library name

    -mr  specify that a REGISTERED call interface library is to be
     generated (for DICE -m[r,R,RR] options), else generates a normal
     stack-args interface library.

    -mD  specify large-data model, else small-data model

 -I include-dir
     passed to DCC

 -p prefix  Set prefix (currently only for standard generation, doesn't work
     with -mr).  The default is a single underscore _.

  -prof  Generate profiling code for the tags.  This will cause all
     library calls to be profiled when the program that links with
     this library is run.

 -auto library
     Generate auto-init code for library after the tags.  library is
     the name of the shared library.  For example, -auto fubar.library

 -AUTO library
     Generate ONLY auto-init code for library (do not generate tags)

 SEE ALSO
 fdtopraga for a description of .fd file format.